The supportDg element is the parent element for reference data group elements. The reference data group element contents define referenced data group elements and data group elements within those referenced data group elements. supportDg functionality is not available in a device template file for all EIEs. When available, it can be used on a data group-by-data group basis.
This element is:
To learn about how this element relates to other elements in a CygNet device template file, see Template File Hierarchy.
For general information about data group dependencies, see Data Group Dependencies.
Note: In the supportDg list in the device template file for FMS data groups, if you want to include a data group that is not included on the FMS ordinal, that data group must be on ordinal 0.
Example
|
<!-- The following example shows the use of a supportDg section in an EFM Data Group. The data element "HrlyIdx" is a child of "DpSupt". "DpSupt" is another data group elsewhere in the template from which this sample came. --> <DpHrlyGQ niceName="DP Hourly Hist GQ" dgCat="enronHistory" forceSave="true" baseOrd="1" maxCnt="12" leadingTime="true" recordMinutes="60" queueSize="840"> <supportDg> <DpSupt deidIndex="HrlyIdx"/> </supportDg> <dgElements byteOrder="bigEndian" secLev="4" type="r4"> <HistDate desc="Date" off="0" hidden="true"/> <HistTime desc="Time HHMMSS" off="4" hidden="true"/> <DateTime desc="DateTime" type="r8"/> </dgElements> <modbusReadBlocks regByteLen="4"> <block1 regNum="704" ordIncrement="2" regCnt="1" funcCode="3"/> </modbusReadBlocks> <uccRecvParms> <SDate required="false" desc="Start Date" type="string"/> <EDate required="false" desc="End Date" type="string"/> </uccRecvParms> </DpHrlyGQ> ... <DpSupt niceName="DP Hist Support" forceSave="true" baseOrd="1" maxCnt="12"> <dgElements byteOrder="bigEndian" secLev="4" type="r4"> <DlyIdx desc="Current Daily Hist Index" regDef="1:0"/> <HrlyIdx desc="Current Hourly Hist Index" regDef="1:1"/> </dgElements> <modbusReadBlocks regByteLen="4"> <block1 regNum="7101" ordIncrement="2" regCnt="2" funcCode="3"/> </modbusReadBlocks> </DpSupt> |
Example
|
<!-- The following example shows the use of a supportDg element in a composite data group. "SupportDG1," "SupportDG2," and "SupportDG3" are other data groups elsewhere in the template from which this sample came. -->
<MyComp niceName="My Composite Data Group" dgCat="composite" canSend="false" dgProtocol="Internal"> <supportDg> <SupportDG1 required="true"/> <SupportDG2 required="false"/> <SupportDG3 required="false"/> </supportDg> <dgElements secLev="4" type="ui2"> <Gravity desc="Gravity" type="vrnt" sourceDg="SupportDG1" sourceDeid="Grav"/> <DP desc="Differential Pressure" type="vrnt" units="psi" fromSupportDg="true"> <source sourceDg="SupportDG2"/> <source sourceDg="SupportDG3" sourceDeid="R1PrPt"/> </DP> </dgElements> <uccRecvParms> <!--uccRecvParms only required if a support data group has associated receive parameters--> <RecParmName desc="Receive Parameter" required="true"/> </uccRecvParms> </MyComp> ... <SupportDG1> <dgElements> <Grav/> </dgElements> </SupportDG1> ... <SupportDG2> <dgElements> <DP/> </dgElements> </SupportDG2> ... <SupportDG3> <dgElements> <R1PrPt/> </dgElements> </SupportDG3> |
The following table lists and describes attributes generally applicable to this element. However, not all of the attributes listed here are applicable to all EIEs. Additionally, some attributes are required for use in every device template file of a certain EIE, but others may be used on a case-by-case or device-by-device basis, depending on your specific needs. All attributes in templates are case sensitive; but the case sensitivity of attribute values is based on context.
Note: Occasionally, device template files for different EIEs use attributes of the same name that do different things. Efforts are made in this document to highlight cases where an attribute by one name does different things in different EIEs.
| Attribute | Description |
|---|---|
|
Specifies whether or not applicable elements are required. Value
|